Fills a rounded rectangle with any available bit pattern.

void FillRoundRect (
    const Rect *r, 
    SInt16 ovalWidth, 
    SInt16 ovalHeight, 
    const Pattern *pat
);

Parameter descriptions

r

The rectangle that defines the rounded rectangle’s boundaries.

ovalWidth

The width of the oval defining the rounded corner.

ovalHeight

The height of the oval defining the rounded corner.

pat

The bit pattern to use for the fill.

DISCUSSION

Using the patCopy pattern mode, the FillRoundRect function draws the interior of the rounded rectangle bounded by the rectangle that you specify in the r parameter with the bit pattern defined in the Pattern structure that you specify in the pat parameter. Use the ovalWidth and ovalHeight parameters to specify the diameters of curvature for the corners. The pen location does not change.

To fill a rounded rectangle with a pixel pattern, use the FillCRoundRect function.

Use GetPattern and GetIndPattern to get a pattern stored in a resource. Use PaintRoundRect to draw the interior of a rounded rectangle with the pen pattern for the current graphics port.

SPECIAL CONSIDERATIONS

The FillRoundRect function may move or purge memory blocks in the application heap; do not call this function at interrupt time.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)